home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d10 / cal_mate.arc / CALMATE4.DOC < prev    next >
Text File  |  1991-05-04  |  87KB  |  2,752 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                  Calendar Mate V4.0
  10.  
  11.                         (C) Copyright 1989-1991 Hawk Software
  12.                                  All Rights Reserved
  13.  
  14.                                     Hawk Software
  15.                                     P.O Box 3961
  16.                             Regina, Saskatchewan S4P 3R9
  17.                                        Canada
  18.  
  19.                               Compuserve ID: 75130,1650
  20.  
  21.                             Support Line: (306) 543-8899
  22.  
  23.  
  24.  
  25.  
  26.  
  27.                          _______
  28.                     ____|__     |               (Tm)
  29.                   -|       |    |-------------------
  30.                    |   ____|__  |  Association of
  31.                    |  |       |_|  Shareware
  32.                    |__|   o   |    Professionals
  33.                  -----|   |   |---------------------
  34.                       |___|___|    MEMBER
  35.  
  36.              "This program  is produced  by a  member of the Association of
  37.           Shareware Professionals  (ASP).   ASP wants to make sure that the
  38.           shareware principle works for you. If you are unable to resolve a
  39.           shareware-related problem  with an  ASP member  by contacting the
  40.           member directly,  ASP may  be able to help. The ASP Ombudsman can
  41.           help you  resolve a  dispute or  problem with  an ASP member, but
  42.           does not  provide technical support for members' products. Please
  43.           write to  the ASP  Ombudsman at P.O. Box 5786, Bellevue, WA 98006
  44.           or send  a Compuserve  message  via  easyplex  to  ASP  Ombudsman
  45.           70007,3536"
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.           Getting Started                                            7
  53.               The Big Picture                                        7
  54.               The DOS Environment                                    7
  55.               Using different Events files                           8
  56.           The Primary Menu                                           8
  57.               The Convenience Calendar                               8
  58.               The Options Menu                                      10
  59.           Option 1. Events for Today                                11
  60.               Printing this Calendar                                11
  61.               Seeing other days                                     11
  62.               Entering Events                                       12
  63.               Deleting Events                                       12
  64.               Appointment Extend                                    13
  65.           Option 2. File Statistics                                 15
  66.           Option 3. Look at Events File                             16
  67.               Important Keys                                        16
  68.               The Delete command                                    17
  69.               The Undelete command                                  17
  70.               The Change command                                    17
  71.               The Clone Command                                     17
  72.               The Expand Command                                    18
  73.               The Future Command                                    18
  74.                   Deleting an Event                                 18
  75.                   Rescheduling an Event                             19
  76.                   Undoing your changes                              19
  77.               Sorting by date or event                              19
  78.               Adding a Record                                       19
  79.           Option 4. Add a Record                                    20
  80.           Option 5. System Parameters                               24
  81.               5.1.1 Set Default Drivers for Calendars               24
  82.               5.1.2 Prepare or edit your own                        25
  83.               5.2 Set Program Parameters                            27
  84.               5.3 Set Various Colours                               30
  85.               5.4 Select Different Events File                      31
  86.           Option 6. DOS Shell                                       32
  87.           Option 7. Print a Calendar                                33
  88.               Monthly Calendar Overflow                             34
  89.           Option 8. Browse Calendar                                 35
  90.           Option 9. Quit                                            36
  91.           Appendix A. Date/Time Formats                             37
  92.           Appendix B. Data Record Formats                           38
  93.           Appendix C. ASCII Character Set                           39
  94.           Appendix D. Repeating Adjectives                          40
  95.           Appendix E. Some commonly asked questions                 42
  96.           Appendix F. Order Form                                    44
  97.           INDEX                                                     46
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.           Calendar Mate  is designed  to help  you keep  track of important
  105.           events. Many  homes have  a central calendar with everything from
  106.           dental appointments  to birthdays to PTA meetings marked on them.
  107.           With Calendar  Mate, you can enter these events into the database
  108.           and print off a calendar to put up on your wall.
  109.  
  110.           Calendar Mate's  strength lies in its ability to handle repeating
  111.           events. You  can enter  your father's birthday into the database,
  112.           specify that  it is to repeat on a yearly basis and Presto! Every
  113.           year, your father's birthday will be shown on the calendar.
  114.  
  115.           What if  you have to work in the church nursery on the 3rd Sunday
  116.           of the  month or  if you  have a reunion with a friend on the 2nd
  117.           Wednesday in  September? What  if you have a darts game scheduled
  118.           fortnightly? No  problem!  Calendar  Mate  can  handle  repeating
  119.           events easily.
  120.  
  121.           Calendar Mate is extremely flexible. You can delete or reschedule
  122.           a specific  occurrence of  a repeating  event  without  affecting
  123.           other dates  that the  event falls  on. There  are no  cumbersome
  124.           codes to  learn. You  can define events in plain English. You can
  125.           specify the date format -- whether 05/12/90 means May 12, 1990 or
  126.           December 5, 1990.
  127.  
  128.           Calendar Mate  is being  marketed as  Shareware. If you find this
  129.           program to  be of  use, please  register  your  copy.  This  will
  130.           entitle you  to the  current version  of the  program,  unlimited
  131.           technical support,  notification of  future upgrades  and a  good
  132.           feeling, knowing  that you are contributing to the success of the
  133.           Shareware  industry.  For  your  convenience  an  order  form  is
  134.           provided at the end of this document.
  135.  
  136.           What is Shareware?
  137.  
  138.           Shareware distribution  gives users  a  chance  to  try  software
  139.           before buying  it. If  you try  a Shareware  program and continue
  140.           using it,  you are  expected  to  register.  Individual  programs
  141.           differ on  details --  some  request  registration  while  others
  142.           require  it,   some  specify   a  maximum   trial  period.   With
  143.           registration, you  get anything from the simple right to continue
  144.           using the software to an updated program with printed manual.
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.      Introduction                                 Page 3
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.           Copyright laws  apply to  both Shareware  and commercial software
  164.           and the  copyright holder retains all rights, with a few specific
  165.           exceptions as  stated below.  Shareware authors  are accomplished
  166.           programmers, just  like commercial  authors, and the programs are
  167.           of comparable  quality. (In  both cases,  there are good programs
  168.           and  bad   ones!)  The  main  difference  is  in  the  method  of
  169.           distribution. The  author specifically  grants the  right to copy
  170.           and distribute  the software,  either to  all and  sundry or to a
  171.           specific  group.   For  example,  some  authors  require  written
  172.           permission  before  a  commercial  disk  vendor  may  copy  their
  173.           Shareware.
  174.  
  175.           Shareware is  a distribution  method, not a type of software. You
  176.           should find  software  that  suits  your  needs  and  pocketbook,
  177.           whether it's  commercial or Shareware. The Shareware system makes
  178.           fitting your  needs easier,  because you  can try before you buy.
  179.           And because  the overhead  is low, prices are low also. Shareware
  180.           has the  ultimate money-back  guarantee --  if you  don't use the
  181.           product, you don't pay for it.
  182.  
  183.           DISCLAIMER - AGREEMENT
  184.  
  185.           Users of  Calendar Mate  must accept this disclaimer of warranty:
  186.           "CALENDAR MATE  IS SUPPLIED  AS IS.   THE  AUTHOR  DISCLAIMS  ALL
  187.           WARRANTIES, EXPRESSED  OR IMPLIED, INCLUDING, WITHOUT LIMITATION,
  188.           THE WARRANTIES OF MERCHANTABILITY AND OF FITNESS FOR ANY PURPOSE.
  189.           THE  AUTHOR   ASSUMES  NO   LIABILITY  FOR   DAMAGES,  DIRECT  OR
  190.           CONSEQUENTIAL, WHICH MAY RESULT FROM THE USE OF CALENDAR MATE."
  191.  
  192.           Calendar Mate  is a  "shareware program"  and is  provided at  no
  193.           charge to  the user  for evaluation.   Feel free to share it with
  194.           your friends,  but please  do not give it away altered or as part
  195.           of another  system.   The essence of "user-supported" software is
  196.           to provide  personal computer users with quality software without
  197.           high prices,  and yet  to provide  incentive for  programmers  to
  198.           continue to develop new products.
  199.  
  200.           If you  find this  program useful  and find  that you  are  using
  201.           Calendar  Mate   and  continue  to  use  Calendar  Mate  after  a
  202.           reasonable trial  period, you must make a registration payment of
  203.           $22.00 to Hawk Software. The $22.00 registration fee will license
  204.           one copy for use on any one  computer at any one time.
  205.  
  206.           You must  treat this  software just  like a  book.  For  example,
  207.           although this  software may  be used  by any number of people and
  208.           may be  freely moved from one computer location to another, there
  209.           must be no possibility of it being used at more than one location
  210.           at the same time it is being used at another.
  211.  
  212.  
  213.  
  214.  
  215.      Calendar Mate 4.0 User Reference Guide       Page 4
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.           Commercial users of Calendar Mate must register and pay for their
  223.           copies of  Calendar Mate  within 30  days of  first use  or their
  224.           license is  withdrawn.   Site-License arrangements may be made by
  225.           contacting Hawk Software.
  226.  
  227.           Anyone distributing  Calendar Mate  for any  kind of remuneration
  228.           must first  contact  Hawk  Software  at  the  address  below  for
  229.           authorization. This  authorization will  be automatically granted
  230.           to distributors  recognized by  the  (ASP)  as  adhering  to  its
  231.           guidelines for  shareware distributors, and such distributors may
  232.           begin offering  Calendar Mate  immediately (However Hawk Software
  233.           must still  be advised so that the distributor can be kept up-to-
  234.           date with the latest version of Calendar Mate.).
  235.  
  236.           You are  encouraged to pass a copy of Calendar Mate along to your
  237.           friends for  evaluation.  Please encourage them to register their
  238.           copy if  they find  that they  can use  it.  All registered users
  239.           will receive  a copy  of the  latest version of the Calendar Mate
  240.           system,  unlimited  phone  support  and  notification  of  future
  241.           releases of the program.
  242.  
  243.           Since one  of the  main goals  of Hawk  Software is  to provide a
  244.           quality product,  your input  is very valuable to us. Please feel
  245.           free to send us your ideas for enhancements. We would  especially
  246.           appreciate hearing about any bugs you might come across.
  247.  
  248.           System Requirements
  249.  
  250.           This program  runs on an IBM PC/XT/AT or compatible with at least
  251.           384K of  RAM. The  more memory,  the bigger  the database you can
  252.           have. The  program has  been tested  with DOS  3.0 and higher and
  253.           works. Your  monitor can  be Monochrome, CGA, EGA or VGA. You can
  254.           use a floppy or hard drive to store the data.
  255.  
  256.           In order  to print  calendars, you  need  a  printer  capable  of
  257.           printing graphics  characters. Several print drivers are supplied
  258.           with Calendar  Mate and  most printers  are supported. If none of
  259.           the print  drivers work  you may  have to  change some dip switch
  260.           settings on  your printer.  Your printer  manual will provide you
  261.           with this  information. Some  of the keywords to look for include
  262.           'IBM  Character   Set  II'  on  most  printers,  'Epson  Extended
  263.           Character Set'  on Epson  printers, 'IBM Proprinter Mode' on Star
  264.           printers. If  you need  help, call the support line listed on the
  265.           front page of this manual.
  266.  
  267.           Please note  that on-line  help information  is available to you.
  268.           Press  F1   from  wherever   you  are   in  the  program  and  an
  269.           instructional window will appear.
  270.  
  271.  
  272.  
  273.  
  274.      Introduction                                 Page 5
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.           Most Special Mentions
  282.  
  283.           Special thanks  go to  my unflappable  beta testers,  Peter Amos,
  284.           John Notor,  George Abbott, Jim Levin and especially Mike LeDuke,
  285.           my documentation editor.
  286.  
  287.           However, the people who really made this program possible were my
  288.           wife Laura  and two  Hawklings Juliana  and Joshua whose patience
  289.           during the development of this program kept me going.
  290.  
  291.           ...Rick Hawkes...
  292.  
  293.           Acknowledgements
  294.  
  295.           "IBM",  "IBM  PC"  and  "PC-DOS"  are  registered  trademarks  of
  296.           International Business Machines Inc.
  297.           MS-DOS is a U.S. registered trademark of Microsoft Corporation
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.      Calendar Mate 4.0 User Reference Guide       Page 6
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.           Getting Started
  341.  
  342.  
  343.  
  344.           After a nearly disastrous install program that came packaged with
  345.           version 3  of Calendar  Mate comes  the light  of  day.  Although
  346.           Calendar Mate  will run  directly from the distribution diskette,
  347.           there is  a program  called SETUP  which will remind you that you
  348.           can set  the language  of the  calendars, the date format and the
  349.           print drivers.  All of these things can be setup in Calendar Mate
  350.           as well but it's nice to get that sort of customization stuff out
  351.           of the way early on.
  352.  
  353.           To run  SETUP, make  sure that  you are  in the subdirectory that
  354.           contains all the Calendar Mate files and type in
  355.  
  356.           SETUP
  357.  
  358.           You will  be asked  a few questions that you can respond to. Most
  359.           things that  can go wrong with setup happen if you are running it
  360.           from  a  different  subdirectory  that  the  one  containing  the
  361.           Calendar Mate  files. If  you want  to run  Calendar Mate  from a
  362.           subdirectory on your hard drive. simply copy the files, using the
  363.           DOS copy command.
  364.  
  365.           The Big Picture
  366.  
  367.           There  are  several  files  used  by  Calendar  Mate  during  its
  368.           operation. The  help information,  print  drivers,  customization
  369.           information and  your events  all reside  in different  files and
  370.           Calendar Mate  needs to  know where  to find  them. There are two
  371.           ways that  you can  tell the  Mate where his files are: either by
  372.           running Calendar  Mate from  the subdirectory where all his files
  373.           are or by setting a DOS Environment variable.
  374.  
  375.           The DOS Environment
  376.  
  377.           If you  want to  run Calendar  Mate from  anywhere, you can set a
  378.           special flag  so that  the Mate  can find  out from DOS where his
  379.           files are.  The special variable is called CMATE4 and you have to
  380.           type in
  381.  
  382.           SET CMATE4=C:\CALMATE4
  383.  
  384.           assuming that  C:\CALMATE4 is  the directory where the data is to
  385.           be found.  If  your  files  are  in  another  subdirectory  on  a
  386.           different drive, enter that information instead.
  387.  
  388.  
  389.  
  390.  
  391.  
  392.      Introduction                                 Page 7
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.           This command  can be  typed  in  from  the  command  line  before
  400.           starting Calendar  Mate or  can be  inserted in your AUTOEXEC.BAT
  401.           file. If  entered from  the command  line, it  will be  effective
  402.           until the next bootup of your system.
  403.  
  404.           Using different Events files
  405.  
  406.           Calendar Mate  will allow  you to  use as  many different  events
  407.           files as  you like. These files are separate and cannot be merged
  408.           or viewed  together. If  you have  different calendars  for work,
  409.           home and  school, you  may enter  the name  of the events file at
  410.           program startup like this:
  411.  
  412.           CALENDAR SCHOOL     Calendar Mate will look for SCHOOL.CME
  413.  
  414.           CALENDAR FRED       Calendar Mate will look for FRED.CME
  415.  
  416.           Simply entering  CALENDAR without  any filename  will cause it to
  417.           look for CALEVENT.CME.
  418.  
  419.           The Primary Menu
  420.  
  421.           When you  get Calendar  Mate started, after the title screen, you
  422.           will see  the Primary  Menu. On  the top  line to the left of the
  423.           title, the  current day and date is displayed. On the top line to
  424.           the right  of the  title is the current day in Julian format. The
  425.           Julian date  consists of  the two last digits of the current year
  426.           followed by  the relative  day in  the year (i.e. January 3 is 3,
  427.           February 1 is 32).
  428.  
  429.           To the  extreme right of the title is a clock showing the current
  430.           time (as  accurately as  DOS knows).  The clock  is updated every
  431.           minute.
  432.           The Convenience Calendar
  433.  
  434.           In the  middle of  the screen  is this month's calendar. Calendar
  435.           Mate takes its cue from DOS. If you haven't set the correct  date
  436.           and time, you will have an inaccurate calendar on your screen. No
  437.           matter, you  can change it. To set the date, exit the program and
  438.           from the Dos prompt, type in DATE and press <ENTER>
  439.  
  440.           Dos will  ask you  to enter the current date and you reply in the
  441.           format specified.  You can  also set  the time by typing  TIME at
  442.           the Dos prompt and pressing <ENTER>. See your Dos manual for more
  443.           details.
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.      Calendar Mate 4.0 User Reference Guide       Page 8
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.           There are  a number of keys on your keyboard for manipulating the
  459.           convenience calendar. These keys are
  460.  
  461.  
  462.           Up Arrow       Display the next year
  463.                          If the current calendar is May 1989,
  464.                          this key will display May 1990
  465.  
  466.           Down Arrow     Display the previous year
  467.                          If the current calendar is May 1989,
  468.                          this key will display May 1988
  469.  
  470.           Left Arrow     Display the previous month
  471.                          If the current calendar is May 1989,
  472.                          this key will display April 1989
  473.  
  474.           Right Arrow    Display the next month
  475.                          If the current calendar is May 1989,
  476.                          this key will display June 1989
  477.  
  478.           Ins            Add 100 to the year (next century)
  479.                          If the current calendar is May 1989,
  480.                          this key will display May 2089
  481.  
  482.           Del            Subtract 100 from the year
  483.                          If the current calendar is May 1989,
  484.                          this key will display May 1889
  485.  
  486.           Home           Back to today's calendar
  487.                          Hitting this key will reset the
  488.                          calendar to the system date
  489.  
  490.           PgDn           Hilight the previous day
  491.  
  492.           PgUp           Hilight the next day
  493.  
  494.           If you have a mouse installed, a few extra characters will appear
  495.           on the  bottom of  the convenience  calendar. They  are meant  to
  496.           represent the  arrows on your keyboard. If you position the mouse
  497.           cursor on  one of  the characters  and click the mouse button, it
  498.           will behave  the same  way as  the similar looking arrow key. The
  499.           character that  looks like  a box  with a  hole in  the middle is
  500.           meant to represent the 'Home' key.
  501.  
  502.           You may  also position  the  mouse  cursor  over  a  day  on  the
  503.           calendar, click  the mouse  button, and  that day will become the
  504.           current day.  This behaves  much like  the PgDn and PgUp keys but
  505.           faster because you can target a specific day.
  506.  
  507.  
  508.  
  509.  
  510.      Introduction                                 Page 9
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.           Hilighting the  previous day  or the next day are meaningful when
  518.           you select option 1 from the options menu. This will be discussed
  519.           in detail momentarily.
  520.  
  521.           Example Exercise
  522.  
  523.           Look at October 1582.
  524.  
  525.           1) If  your current  month isn't October, press the left or right
  526.           arrow keys  until October  is displayed  in  the  center  of  the
  527.           screen.
  528.  
  529.           2) Now  press the  up or down arrow keys. Remember that this will
  530.           change the year backward or forward one year. Keep pressing until
  531.           you get to 1982.
  532.  
  533.           3) Now press the 'Delete' key a few times until you come to 1582.
  534.           Remember that  the delete  key moves  the date in the convenience
  535.           calendar one century backward.
  536.  
  537.           Interestingly enough,  October 1582  was a  pivotal month  in the
  538.           history of  the calendar.  The pope  at the  time,  Gregory,  was
  539.           advised that  because of  an anomaly  in the  calendars  so  far,
  540.           Easter was  in danger  of becoming  a summer  event.  So  Gregory
  541.           deleted 10  days from  the calendar  that month  to correct this.
  542.           This was the start of what we call the Gregorian calendar.
  543.  
  544.           4) To come back to today, press the 'Home' key.
  545.  
  546.           The Options Menu
  547.  
  548.           At the  bottom of  the main  screen is  the options menu. You may
  549.           select a  function either by number or by the hilighted letter in
  550.           the description.  If you  have a  mouse installed,  to select  an
  551.           option position the mouse cursor beside that option and click the
  552.           mouse button.
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.      Calendar Mate 4.0 User Reference Guide       Page 10
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.           Option 1. Events for Today
  577.  
  578.           Introduction
  579.  
  580.           This screen  will display  two  things,  events  that  have  been
  581.           scheduled for  today's date  and any  future events for which you
  582.           have scheduled an early warning that are coming up soon.
  583.  
  584.           In the system parameters file (option 5 on the main menu) you can
  585.           specify the  hours to  be displayed on this screen and the number
  586.           of intervals in the hour.
  587.  
  588.           If you  have scheduled an event whose time exactly matches a time
  589.           period on  this  screen,  the  event  will  be  displayed  there.
  590.           Otherwise, the  event will  be displayed  in the blank area below
  591.           the time periods listed on the screen.
  592.  
  593.           Printing this Calendar
  594.  
  595.  
  596.  
  597.           To print  this calendar,  press the  F8 key. To dump it to a disk
  598.           file, press F9. When you print this calendar, early warnings will
  599.           show in the bottom right section of the printout. When printing a
  600.           daily calendar  (but not  viewing on the screen), you may want to
  601.           see events far in advance of their actual date. The early warning
  602.           that you specify when you define the event can be overridden by a
  603.           parameter in option 5.2. See that section for further details.
  604.  
  605.           Seeing other days
  606.  
  607.            There  are several  ways to  have a look at another day's events
  608.           from this screen.
  609.  
  610.           1) PgDn = next day
  611.  
  612.           2) PgUp = previous day
  613.  
  614.           3) Enter  the date to skip to. See appendix A for a list of valid
  615.           date formats.
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.      Introduction                                 Page 11
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.           4) If you want to see the events scheduled for next Wednesday, on
  636.           the input  line, type  nw and  press <Enter>.  The letter  'n' is
  637.           interpreted by  Calendar Mate  as meaning  'next'. Similarly, the
  638.           letter 'l' is interpreted as meaning 'last'. For the day, use the
  639.           following table.
  640.  
  641.  
  642.            Day                Code
  643.  
  644.           Sunday              s
  645.           Monday              m
  646.           Tuesday             t
  647.           Wednesday           w
  648.           Thursday            th
  649.           Friday              f
  650.           Saturday            sa
  651.  
  652.  
  653.           Entering Events
  654.  
  655.           To enter  events into  the database  directly from  this  screen,
  656.           press F10. The input line will move to the first time period. Use
  657.           the tab keys or the up and down arrow keys to move the input area
  658.           to the desired time period.
  659.  
  660.           If you have a mouse, place the cursor beside a time and click the
  661.           button. Enter your event in the input area displayed.
  662.  
  663.           When you have entered your appointment/event, press the enter key
  664.           to save  it. When  you have finished, press the ESC key to return
  665.           to the main menu.
  666.  
  667.           Deleting Events
  668.  
  669.           To delete  an appointment  from your  daily calendar,  enter  the
  670.           command
  671.  
  672.           D xxxx
  673.  
  674.           where xxxx  represents the time the appointment is scheduled. You
  675.           may use  any supported  format when  specifying  the  time.  This
  676.           command only  works for  events that  occur between the start and
  677.           end  hours   that  you   specify  in   'System  Parameters'.  Any
  678.           appointments that  are scheduled  outside  those  hours  must  be
  679.           deleted using option 3 from the main menu.
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.      Calendar Mate 4.0 User Reference Guide       Page 12
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.           Appointment Extend
  695.  
  696.           If your  event will  span  more  than  one  time  slot,  use  the
  697.           Appointment Extend  feature. In  input mode  press the F6 key and
  698.           then use  the arrow  and tab  keys  to  move  to  different  time
  699.           periods. The text of your event will travel with the input area.
  700.  
  701.           The Appointment Extend feature will move whatever text was on the
  702.           input line  before the  F6 key is hit. You can use this to extend
  703.           an appointment  that has already been made and save yourself some
  704.           keystrokes. See  example 3  below. The restriction of Appointment
  705.           Extend is that it can only be used for consecutive time slots.
  706.  
  707.           Example 1
  708.  
  709.           Suppose you  want to schedule a short meeting with Frank at 10:00
  710.           a.m.
  711.  
  712.           1) Press F10
  713.  
  714.           2) Use the down arrow key to move the input area to 10:00
  715.  
  716.           3) Type 'Meeting with Frank'
  717.  
  718.           4) Press the Enter (or return) key to register the event.
  719.  
  720.           Example 2
  721.  
  722.           You must give a lecture on baseball strategy from 9:30 to 11:00
  723.  
  724.           1) Press F10
  725.  
  726.           2) Press F6 for Appointment Extend
  727.  
  728.           3) Use the down arrow key to move the input area to 9:30
  729.  
  730.           4) Type 'Strategy Lecture'
  731.  
  732.           5) Use the down arrow key to move to 11:00
  733.  
  734.           6) Press the Enter (or return) key to register the event.
  735.  
  736.           7) Press ESC to return to the main menu.
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.      Option 1: Events for Today                        Page 13
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.           Example 3
  754.  
  755.           You've scheduled  a meeting  with a  salesman at  9:00  but  he's
  756.           called and  told you that he'll need 1 hour instead of 30 minutes
  757.           to make his presentation. To mark that on your calendar,
  758.  
  759.           1) Press F10.
  760.  
  761.           2) Use the down arrow key to move the input area to 9:00
  762.  
  763.           3) Press F6 for Appointment Extend
  764.  
  765.           4) Press the down arrow key to extend the appointment.
  766.  
  767.           5) Press Enter (or return) to register the event.
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.      Calendar Mate 4.0 User Reference Guide       Page 14
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.           Option 2. File Statistics
  813.  
  814.           This option  shows the number of records in the current database,
  815.           the number  of deleted  records and  the 'number  of memory slots
  816.           left'. When  the program starts, it determines how much memory it
  817.           needs to  load the  database and  then adds some to allow for the
  818.           addition of  more records. If your additional records exceed this
  819.           allocated memory,  Calendar Mate  will save  the  data  file  and
  820.           allocate more memory.
  821.  
  822.           A record  will be  flagged  as  deletable  when  a  non-repeating
  823.           event's date  has passed  or you  explicitly deleted  an event in
  824.           option 3.
  825.  
  826.           When a  record is  flagged as  deletable, it  will remain  in the
  827.           database until  you save the database (using the autosave option)
  828.           or quit  the program.  Until one  of these events occurs, you can
  829.           recover a deleted event in option 3.
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.      Option 1: Events for Today                        Page 15
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.           Option 3. Look at Events File
  872.  
  873.           This command  will display  a window showing the events database.
  874.           There are  two main types of event records -- repeating  and non-
  875.           repeating --  and these  are displayed  separately, non-repeating
  876.           followed by  repeating. These records will be sorted in ascending
  877.           date order  and optionally  by time  as well (See section 5.2 for
  878.           information on  how to  sort the  database by  time). A repeating
  879.           event will  be identified  with an  asterisk to  the right of the
  880.           date.
  881.  
  882.           Important Keys on this Screen
  883.  
  884.           F1             Help Information
  885.  
  886.           F8             Sort file by date or event
  887.  
  888.           F9             Skip to top of file
  889.  
  890.           F10            Skip to end of file
  891.  
  892.           PgDn           Scroll forward a screen
  893.  
  894.           PgUp           Scroll backward a screen
  895.  
  896.           Up arrow       Move up 1 event
  897.  
  898.           Down arrow     Move down 1 event
  899.  
  900.           Esc            Close the window
  901.  
  902.           There are 6 one letter commands that you can use on this screen.
  903.  
  904.           C              Change the record
  905.  
  906.           F              Show Future occurrences of a repeating event
  907.  
  908.           L              Clone an existing record
  909.  
  910.           D              Delete the record
  911.  
  912.           U              Undelete the record
  913.  
  914.           X              Expand the record to see more data
  915.  
  916.           Enter any of these commands in the input area beside a record.
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.      Calendar Mate 4.0 User Reference Guide       Page 16
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.           With a mouse  you may execute any of the above mentioned commands
  931.           by positioning  the mouse  cursor on the command and clicking the
  932.           button.
  933.  
  934.           As well,  instead of  using the arrow keys to move the input area
  935.           beside a  record, you  may position  the mouse  cursor  beside  a
  936.           record and click a button to select that record.
  937.  
  938.           The Delete command
  939.  
  940.           Use this  command to  delete a record from the database. When you
  941.           do this, the record will be deleted the next time the database is
  942.           sorted and  saved to  disk. Until  then, if  you change your mind
  943.           about deleting the record, you may undelete it.
  944.  
  945.           The Undelete command
  946.  
  947.           This command  undeletes a  record from the database. It will undo
  948.           the action of the D (delete) command.
  949.  
  950.           The Change command
  951.  
  952.           This command  is used  to change  the event  record - date, time,
  953.           early warning,  description, etc.  When you enter the 'C' command
  954.           beside the  record, you  will see  an input window not unlike the
  955.           'Add a  Record' screen.  The fields  will be filled with the data
  956.           that you  had specified  before. You  may now  make  any  desired
  957.           changes. When  you have  changed a  field, press  the  Enter  (or
  958.           return) key. Then press F5 to save your changes.
  959.  
  960.           The Clone Command
  961.  
  962.           The purpose  of this  command is  to make  a copy  of an existing
  963.           record and allow you to change some of the fields within it.
  964.  
  965.           For example  if you're putting your team's softball schedule into
  966.           Calendar Mate, this command can save a lot of typing. What you do
  967.           is create  a record  (using option 4 from the main menu) and save
  968.           it.
  969.  
  970.           Then, from  the main  menu, choose  option 3 to get back here and
  971.           clone the record by putting an 'L' beside the event. You'll see a
  972.           menu that  looks just  like  the  'change  a  record'  menu.  The
  973.           difference is  that you're  creating a whole new record, using an
  974.           existing one as a template. Now change any fields you need to and
  975.           hit F5 to save it.
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.      Option 3: Look at Events File                Page 17                                                       
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.           The Expand Command
  990.  
  991.           This command  will help you to remember some of the fields in the
  992.           record that  aren't shown  on the  menu. Enter  an X  beside  the
  993.           record and  the program will display the entire record and make a
  994.           best guess  at interpreting the repeat field. Please note that if
  995.           you  have  specified  weekly  or  fortnightly,  the  program  may
  996.           interpret the repeat field as '7 days' or '14 days' respectively.
  997.  
  998.           The Future Command
  999.  
  1000.           This powerful  command will  show the  future  occurrences  of  a
  1001.           repeating  event.  When  you  select  this  option  you  will  be
  1002.           presented with  another menu  showing you the next 10 occurrences
  1003.           of the event.
  1004.  
  1005.           From this  menu, you  may scroll  forward and  backward using the
  1006.           PgUp and PgDn commands.
  1007.  
  1008.           As well, there are three commands you may enter from here
  1009.  
  1010.           R              Reschedule an Event
  1011.  
  1012.           D              Delete this occurrence of the event
  1013.  
  1014.           U              Undo the effects of the above two commands
  1015.  
  1016.           Note: These  commands deal  with repeating  events only. When you
  1017.           delete or  reschedule an event from this part of the program, you
  1018.           are deleting or rescheduling one occurrence only.
  1019.  
  1020.           Deleting an Event
  1021.  
  1022.           Suppose you  have a Rotary Club meeting on the 2nd Tuesday of the
  1023.           month except for the summer months. You have defined the event as
  1024.           a repeater but do not want it to appear on your calendar for July
  1025.           and August. By putting a 'D' beside the dates you want to cancel,
  1026.           you will  not have  to see  that event  on your  calendars. As  a
  1027.           reminder, the program will put the word 'Deleted' to the right of
  1028.           the date you cancelled.
  1029.  
  1030.           The way the program accomplishes this is to create another record
  1031.           in the  database. If,  for any  reason, you  delete  the  'master
  1032.           event' (the  repeater that  this is associated with) any of these
  1033.           special records  will be  deleted  as  well.  Unlike  the  normal
  1034.           records in  the database that can sometimes be recovered with the
  1035.           'undelete' command, these records are lost forever if deleted.
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.      Calendar Mate 4.0 User Reference Guide       Page 18
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.           Rescheduling an Event
  1049.  
  1050.           This is  similar to deleting an event except that you want to see
  1051.           it some other time. For example, you have a squash game scheduled
  1052.           every Tuesday  after work  but you  cannot play  next Tuesday and
  1053.           would rather reschedule the game to Wednesday.
  1054.  
  1055.           If this  is the case, put an 'R' beside the date. A menu like the
  1056.           'change' and  'clone' menus  will be  displayed. Fill  in the new
  1057.           date or  time of  the event.  Press F5  to save it. Calendar Mate
  1058.           will  display   the  new   date  of   the  event  with  the  word
  1059.           'Rescheduled' shown  to remind  you. When  you  print  a  monthly
  1060.           calendar or  display a  daily calendar,  the event will appear in
  1061.           its new time period.
  1062.  
  1063.           When you  reschedule an  occurrence of  a  repeating  event,  the
  1064.           program will  create a  non-repeating event  at the  new time  or
  1065.           date. Although  it looks  like a  normal non-repeating  event, it
  1066.           cannot be  deleted from  the events  file the  way  you  normally
  1067.           delete events.
  1068.  
  1069.           Undoing your changes
  1070.  
  1071.           If you have to 'undelete' or 'un-reschedule' an event, type a 'U'
  1072.           beside the  date that  has been deleted or rescheduled. This will
  1073.           restore the event to its previous state.
  1074.  
  1075.           If you  have rescheduled the event (and the program has created a
  1076.           non-repeating record) the non-repeating record will be deleted.
  1077.  
  1078.           Sorting by date or event
  1079.  
  1080.           You may  display the file sorted by date or by event. The default
  1081.           sorting is  by date.  If you  press the  F8 key, the file will be
  1082.           sorted differently  from how  you see  it. If it's sorted by date
  1083.           and you press F8, it will be sorted by event and vice versa.
  1084.  
  1085.           Adding a Record
  1086.  
  1087.           To add  a record  from this  screen, press  the Ctrl and 'A' keys
  1088.           simultaneously. This will present you with the menu from option 4
  1089.           which is the subject of the next chapter.
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.      Option 3: Look at Events File                Page 19                                                       
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.           Option 4. Add a Record
  1108.  
  1109.             When you choose this option you will be presented with an input
  1110.           window like this
  1111.  
  1112.           Enter Date     :
  1113.           Enter Time     : 0000
  1114.           Description    :
  1115.           Daily Cal      :
  1116.           Repeat         :
  1117.           Early Warn     :
  1118.  
  1119.           Note that  once you  have entered  all the  appropriate data, you
  1120.           should press  F5 to  save the  record.  If,  while  defining  the
  1121.           record, you  decide that  you want  to start  over, press  ESC to
  1122.           close the window and discard the record.
  1123.  
  1124.           Enter Date
  1125.  
  1126.           The input  area will be positioned beside the 'Enter Date' field.
  1127.           Specify the  date of  the event (for non-repeating events) or the
  1128.           starting date  of the event (for repeaters). You will be reminded
  1129.           of the  correct format  for the  date. See  appendix A for a full
  1130.           listing of  the acceptable  date formats.  If  you  want  to  use
  1131.           today's date,  enter an  asterisk '*'.  The date that is shown is
  1132.           taken from the convenience calendar.
  1133.  
  1134.           Enter Time
  1135.  
  1136.           The 'Enter Time' field is the time the event is scheduled to take
  1137.           place. This  is optional  because you might not care what time an
  1138.           event is  to occur.  For example, you wouldn't specify a time for
  1139.           an event such as Labour Day. If you don't need to specify a time,
  1140.           press enter  here. The default, 0000, tells the program to ignore
  1141.           this field.  There are many time formats the program understands.
  1142.           See Appendix A for a full list of the acceptable formats.
  1143.  
  1144.           Description
  1145.  
  1146.           The 'Description' field allows you to describe the event. You may
  1147.           use up  to 20  characters. This field must have something entered
  1148.           in it to allow you to fill in other fields.
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.      Calendar Mate 4.0 User Reference Guide       Page 20
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.           Daily Cal
  1167.  
  1168.           The 'Daily  Cal' field  gives you the option of having this event
  1169.           appear on the daily calendar and/or monthly calendar. The default
  1170.           is 'Y'. You may enter any of the following options...
  1171.  
  1172.           Y or B    Print event on monthly and daily calendars
  1173.           N or M    Print this on monthly calendar only
  1174.           D         Print this on the daily calendar only
  1175.  
  1176.           Early Warn
  1177.  
  1178.           The early warning  will display an advance warning of an upcoming
  1179.           event. The  early warning  will appear  on the  daily calendar  a
  1180.           specified number of days in advance of the event. You may specify
  1181.           up to 99 days in advance.
  1182.  
  1183.           Warning: If  you use too large a number here (greater than 7 days
  1184.           or so)   the  program will  slow down  quite  substantially  when
  1185.           displaying the daily events.
  1186.  
  1187.           Repeat
  1188.  
  1189.           The 'Repeat' field calls for a Y, N or S response.
  1190.  
  1191.           1) If this is a one time event, reply N
  1192.  
  1193.           2) If this event is to come up on a regular basis, reply Y.
  1194.  
  1195.           3) If the event is a special repeater, reply S.
  1196.  
  1197.  
  1198.  
  1199.           There are  two types  of 'special repeating' events that Calendar
  1200.           Mate can  handle. The  first type  is an  event that  recurs on a
  1201.           regular interval  unless the  date it  falls on  is a weekend. It
  1202.           will then  be rescheduled  to the  previous workday  or the  next
  1203.           workday depending on your preference.
  1204.  
  1205.           An example  of this type of special repeater is the way that many
  1206.           companies pay their employees - twice per month. The first payday
  1207.           falls on the 15th of the month unless that day falls on a weekend
  1208.           or holiday  in which  case the  employees will  be  paid  on  the
  1209.           previous workday.
  1210.  
  1211.           The second type of special repeater is a specific date - February
  1212.           29. If  your birthday  falls  on  that  day,  you  will  want  to
  1213.           celebrate it on the 28th of February in non-leap years.
  1214.  
  1215.  
  1216.  
  1217.  
  1218.      Option 4: Add a Record                       Page 21                                                       
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.           If you  reply 'S' you will be prompted for the special processing
  1226.           instructions. If  you reply  Y and  press enter, the program will
  1227.           show you  two more  lines so  that the input screen will now look
  1228.           like...
  1229.  
  1230.           Enter Date     : dd/mm/yy
  1231.           Enter Time     : 0000
  1232.           Description    : Testing Event
  1233.           Daily Cal      : Y
  1234.           Repeat         : Y
  1235.           Early Warn     : 00
  1236.           Frequency      : Annually
  1237.           End Date       : Eternity
  1238.           Special Proc   :              (If you selected 'S')
  1239.  
  1240.           Frequency
  1241.  
  1242.           In the  'Frequency' field you tell the program how often an event
  1243.           recurs. The  program will  allow you  to describe  many types  of
  1244.           repeating events. Some specific examples include:
  1245.  
  1246.           3rd Workday of the month
  1247.           Every 4 days
  1248.           1st Monday in September
  1249.           2nd Sunday of the month
  1250.           Last workday
  1251.           Daily
  1252.           Every workday
  1253.           Mon, Wed, Fri
  1254.           Tues-Thur
  1255.  
  1256.           See appendix  D for  a complete list of repeating adjectives that
  1257.           the program understands.
  1258.  
  1259.           End date
  1260.  
  1261.           In this field tell the program to ignore a repeating  event after
  1262.           a certain date. Use this field, for example, when describing your
  1263.           vacation to  the program.  If your vacation starts on 12Aug91 and
  1264.           ends two  weeks later  on 26Aug91,  how would you arrange to have
  1265.           this event  printed on  your calendar  for each  day you  are  on
  1266.           vacation?   Specify 'daily' for frequency and 27Aug91 for the end
  1267.           date. If  the end  date is  less than  the start  date (which can
  1268.           happen around  January before  you get  used to the new year) the
  1269.           program will warn you.
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.      Calendar Mate 4.0 User Reference Guide       Page 22
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.           Another way  to specify the end date is to reply '+nnn' where nnn
  1285.           represents a  number of  days. In  the above  example, instead of
  1286.           specifying 27Aug91  as the end date, you could specify +15 as the
  1287.           end date. The program would then compute the proper end date.
  1288.  
  1289.           The date  you specify  as the end date isn't included in the span
  1290.           of the  event. It's  the first day after the event has completed.
  1291.           For example, if you have to attend a conference from October 12th
  1292.           to October 14th, specify October 15th as the ending date.
  1293.  
  1294.           The default for the end date is 'Eternity'. The program will keep
  1295.           this event repeating until you delete it manually.
  1296.  
  1297.           Special Processing
  1298.  
  1299.           If you  have defined an event as a 'special repeater' you'll have
  1300.           to specify  what to  do if  the event  falls on  a weekend.  Your
  1301.           options are
  1302.  
  1303.           P    to reschedule event to the previous workday
  1304.  
  1305.           N    to reschedule event to the next workday
  1306.  
  1307.           D    to delete this occurrence of the event
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.      Option 4: Add a Record                       Page 23                                                       
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.           Option 5. System Parameters
  1344.  
  1345.           There are a number of user definable system parameters available.
  1346.           When you select option 5, you will be presented with this menu.
  1347.  
  1348.           1) Set Printer Parms
  1349.           2) Set Program Parms
  1350.           3) Set Various Colours
  1351.           4) Select new data file
  1352.  
  1353.           The  following   three  sections   will  discuss  each  of  those
  1354.           selections in detail.
  1355.  
  1356.           5.1 Set Printer Parameters
  1357.  
  1358.           When it  comes to setting up your printer, you may be able to use
  1359.           a print  driver that  comes with Calendar Mate or you may have to
  1360.           create your own. Read on to see what's involved!
  1361.  
  1362.           5.1.1 Set Default Drivers for Calendars
  1363.  
  1364.           Calendar Mate  currently can  print  three  types  of  calendars:
  1365.           daily, monthly  and yearly.  You may  specify a  different  print
  1366.           driver for  each one  if you wish. This is particularly useful if
  1367.           you like  to print  monthly calendars  in landscape  mode  (since
  1368.           daily and yearly have to be in portrait mode).
  1369.  
  1370.           To select  a print driver, first of all select which calendar you
  1371.           wish to talk about. You will then be presented with a list of all
  1372.           print drivers  that Calendar  Mate can  find. Enter any non-blank
  1373.           character beside the appropriate driver and the change will be in
  1374.           effect the next time you print.
  1375.  
  1376.           Calendar Mate  prints using special characters for the borders of
  1377.           the calendars  and if  your printer  isn't set  up properly,  the
  1378.           borders will  appear as italicized C's and D's instead of the box
  1379.           characters. The  following  illustration  uses  all  the  special
  1380.           characters. If  it looks  like italic characters, you're going to
  1381.           need a print driver.
  1382.  
  1383.                          ┌──┬──┐
  1384.                          ├──┼──┤
  1385.                          └──┴──┘
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.      Calendar Mate 4.0 User Reference Guide       Page 24
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.           There are  several print drivers shipped with Calendar Mate which
  1403.           will send  control codes  to your  printer. Of  course, there are
  1404.           many kinds  of printers  out there  but most of them will emulate
  1405.           one of a couple of main types. I have found that there are 5 main
  1406.           ones -
  1407.  
  1408.           Epson LQ series
  1409.  
  1410.           Epson FX, LX, RX series
  1411.  
  1412.           IBM Proprinter
  1413.  
  1414.           Hewlett Packard Laserjet
  1415.  
  1416.           Hewlett Packard Deskjet
  1417.  
  1418.           If you know that your printer emulates one of the above printers,
  1419.           select  the  one  that's  appropriate.  Simply  put  a  non-blank
  1420.           character (such  as an X) beside the print driver you require and
  1421.           press Enter.  Then try  to print  a calendar.  If it  looks nice,
  1422.           you've got  the right  one. If not, you may have to read the next
  1423.           section.
  1424.  
  1425.           5.1.2 Prepare or edit your own
  1426.  
  1427.           Monthly calendar  prints use  three fonts -- normal, double width
  1428.           and compressed. If monthly calendars print nicely on your printer
  1429.           you won't  have to  go through  the arduous process of looking up
  1430.           printer codes.
  1431.  
  1432.           If you  do have to set up the printer codes, please note that the
  1433.           program expects  normal print  to be  10 characters  per inch and
  1434.           double width to be 5 characters per inch. Compressed print may be
  1435.           either 16.67 or 17.1 characters per inch.
  1436.  
  1437.           You should  be able to obtain the printer codes from your printer
  1438.           manual. To  enter the  codes into  Calendar Mate, use the decimal
  1439.           representation of  the codes.  If there  is more  than one  code,
  1440.           separate them  with commas. For example, if your printer needs to
  1441.           receive the code "Esc+w+49" to turn on double width, enter
  1442.  
  1443.           27,119,49      27 is Esc code, 119 is 'w' code
  1444.  
  1445.           or
  1446.  
  1447.           27,w,49        Probably easier
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.      Option 5: System Parameters                  Page 25                                                       
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.           If the  printer code  contains non-numeric characters (letters or
  1462.           other characters  like $%&^)  you may  enter them  as characters.
  1463.           Numbers must  be entered   as  their ASCII  value (as illustrated
  1464.           above).
  1465.  
  1466.           If you  have to  sort out the printer codes and are successful, I
  1467.           would be  most grateful if you would communicate your findings to
  1468.           me so  that  others  will  benefit  from  your  research.  As  an
  1469.           incentive, if  you're the  first person  to send me the codes for
  1470.           your printer I will refund your registration fee.
  1471.  
  1472.           Appendix C  contains a list of ASCII characters and their decimal
  1473.           representation. You  may use this to help you set up your printer
  1474.           codes if necessary.
  1475.  
  1476.           If there  is no  way that you can get Calendar Mate to print nice
  1477.           looking calendars  using the extended character set, you have one
  1478.           last chance.  If you  put a  'p' as  the only  character of  Init
  1479.           String 2,  the program will bypass the extended character set and
  1480.           print using  the normal characters. Although this calendar is not
  1481.           nearly as nice as the other, it works.
  1482.  
  1483.           Creating a new Print Driver.
  1484.  
  1485.           If you need to save your printer codes in a separate print driver
  1486.           you may  do it  in the  following manner:  When you get to option
  1487.           5.1.2, press  F8 and  enter the  name of  the new  driver you are
  1488.           creating. When  you press enter, you will be given an opportunity
  1489.           to give  a brief  description of  the print  driver  so,  in  the
  1490.           future, you will know what the driver does.
  1491.  
  1492.           Why would  you want  to create  another print  driver? Maybe  you
  1493.           would like  to use italic or bold characters on your calendar but
  1494.           would like to create a new driver so the old one isn't destroyed.
  1495.           There are other valid reasons for creating your own drivers. Your
  1496.           imagination is the limit!
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.      Calendar Mate 4.0 User Reference Guide       Page 26
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.           5.2 Set Program Parameters
  1521.  
  1522.           When you select option 5.2 you will be presented with a menu that
  1523.           looks like this:
  1524.  
  1525.           Date Format         : [dmy ]  Date format on displays
  1526.           Auto Sort Data      :  yes    Sort Database when updated?
  1527.           Immediate Purge     :  yes    Auto purge obsolete events
  1528.           Julian Date         :  yes    Put Julian date on monthly calendar
  1529.           Sort by time also   :  no     Sort file by date and time
  1530.           Current Century     :  1900   Century assumed with 2 digit years
  1531.           Start of workday    :  8a     Start hour of daily calendar
  1532.           End of Workday      :  5p     End hour of daily calendar
  1533.           Slots per hour      :  2      Number of intervals on daily cal
  1534.           Print Language      :  Eng    English, Francais, Espanol, Deutsch
  1535.           Disk  80 or 132     :  132    Number of columns for disk output
  1536.           Auto Save Number    :  2      # of changes before saving
  1537.           Lunar Cycle         :  N      Print full/new moon? (G/L/N)
  1538.           Compressed Print    :  Yes    Compressed Event Printing? (Y/N)
  1539.           Override Ewarn      :  99     Override early warning on daily prt
  1540.  
  1541.           Date Format
  1542.  
  1543.           This field  will tell  the program  how to  interpret a date that
  1544.           looks like 12/11/89. Your options are ...
  1545.  
  1546.           dmy       day/month/year  12/11/89 is Nov. 12, 1989
  1547.           mdy       month/day/year  12/11/89 is Dec. 11, 1989
  1548.           ymd       year/month/day  89/12/11 is Dec. 11, 1989
  1549.  
  1550.           A date  set in a format like 12may89 will override the format set
  1551.           up here.
  1552.  
  1553.           Auto Sort Data
  1554.  
  1555.           This option  tells the  program whether  or not  to sort the data
  1556.           before it  is written to disk. The default is 'Yes' and is highly
  1557.           recommended.
  1558.  
  1559.           Immediate purge
  1560.  
  1561.           This option  tells the  program whether  or not to purge obsolete
  1562.           records automatically. An obsolete record is defined as any event
  1563.           -- repeating or not -- whose expiry date has passed.
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.      Option 5: System Parameters                  Page 27                                                       
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.           Julian Date
  1580.  
  1581.           This option  tells the  program whether  or not  to  display  the
  1582.           Julian date  on the  monthly calendar.  The Julian  date  is  the
  1583.           number of the day relative to the start of the year. For example,
  1584.           the julian  date for February 1st is 32, for December 31st is 365
  1585.           (or 366 in a leap year).
  1586.  
  1587.           Sort by time also
  1588.  
  1589.           This option  tells the  program whether you want to sort the data
  1590.           file by time as well as by date. This will cause the sort to take
  1591.           longer but  unless you  have a  very large  data file  (over  500
  1592.           events), the time factor will not be important.
  1593.  
  1594.           Current Century
  1595.  
  1596.           This option  tells the  program what  century a  two  digit  year
  1597.           represents. I.E. if you enter 10/15/89, the program needs to know
  1598.           if you are talking about 1989, 2089, 1889 etc.
  1599.  
  1600.           Start of Workday
  1601.  
  1602.           This option sets the starting time for the daily calendar.
  1603.  
  1604.           End of Workday
  1605.  
  1606.           This option sets the ending time for the daily calendar.
  1607.  
  1608.           Slots per Hour
  1609.  
  1610.           This option tells the program whether you want the daily calendar
  1611.           to have  a time  slot every  15 or 30 minutes. For 15 minute time
  1612.           slots, enter 4 and for 30 minute time slots, enter 2.
  1613.  
  1614.           Print Language
  1615.  
  1616.           Although Calendar  Mate's messages,  prompts and commands are all
  1617.           in English,  you may  print  calendars  in  different  languages.
  1618.           Currently, English,  Spanish, German and French are supported. If
  1619.           you would  like to  see another language supported, send a letter
  1620.           to the  author with  the names of the days of the week and months
  1621.           of the  year and  if the  language uses  characters that  DOS can
  1622.           display, it  will come  out in  the next  version. Since Calendar
  1623.           Mate doesn't  use graphics,  Arabic, Chinese,  Sanscrit, Cerillic
  1624.           and other such alphabets would be impossible to implement.
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.      Calendar Mate 4.0 User Reference Guide       Page 28
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.           Disk Width
  1639.  
  1640.           This option  is similar to the previous one except that it is for
  1641.           output directed  to disk.  This  option  might  differ  from  the
  1642.           previous one if you have some software that will take a disk file
  1643.           and print it sideways on your 80 column printer.
  1644.  
  1645.           Auto save number
  1646.  
  1647.           This option  specifies the number of changes to the database that
  1648.           must be  done before the program saves the file to disk. Set this
  1649.           to any integer value that your nerve will allow.
  1650.  
  1651.           Lunar Cycle
  1652.  
  1653.           Calendar Mate  will compute when the full moon and new moon occur
  1654.           each month.  If you  would like  this printed out on your monthly
  1655.           calendar, specify it here.
  1656.  
  1657.           If your  printer   can print  the 'happy  face' characters  - hex
  1658.           codes 01  and 02  - you  should specify  'G' (graphics character)
  1659.           here. Laser  printers tend  to print  these characters  nicely. A
  1660.           full moon  will be represented by the character 01 (a white happy
  1661.           face) and a new moon by the character 02 (a black happy face).
  1662.  
  1663.           If your  printer (like  mine) cannot  print those characters, you
  1664.           can specify L (for letter). If you select this option, a new moon
  1665.           will be  represented by  the letter  'N' and  a full  moon by the
  1666.           letter 'F'.
  1667.  
  1668.           If you  do not  care when  the new  moon and  full  moon  happen,
  1669.           specify 'N'.
  1670.  
  1671.           Compressed Print
  1672.  
  1673.           Normally, monthly calendars can show two events in each box. When
  1674.           compressed print  is used,  the calendar can show three events in
  1675.           each box. If you want the events to print using a condensed font,
  1676.           specify Yes, otherwise, specify No.
  1677.  
  1678.           Compressed print   brings  some restrictions  with it. You cannot
  1679.           browse a calendar that has been created with compressed print and
  1680.           sent to  disk. Also,  compressed  print  is  supported  only  for
  1681.           calendars that  are 80 or 99 characters wide. If this restriction
  1682.           poses a  problem, contact  Hawk Software and more support will be
  1683.           added.
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.      Option 5: System Parameters                  Page 29                                                       
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.           On the  author's printer,  an EPSON  FX compatible, the calendars
  1698.           look cleaner  if friction  feed is  used, as  opposed to  tractor
  1699.           feed. If  tractor feed  is used,  there are tiny gaps between the
  1700.           characters that make up the vertical lines.
  1701.  
  1702.           Override Ewarn
  1703.  
  1704.           When you define an event with an early warning, it will appear on
  1705.           the daily calendar, starting that number of days before the event
  1706.           actually takes  place. I  have found  that when  I print  a daily
  1707.           calendar it doesn't look as cluttered as the on-line version when
  1708.           there are lots of early warnings.
  1709.  
  1710.           For this  reason, you  can use  this field  to override the early
  1711.           warning value  you specified  when you  defined the event. If the
  1712.           event has  a non-zero  early  warning  value,  this  figure  will
  1713.           override it  on the  daily printed calendar only. You may specify
  1714.           any value from 0 to 99.
  1715.  
  1716.           5.3 Set Various Colours
  1717.  
  1718.           This option allows you to change several window colours. There is
  1719.           another technique,  described  in  the  last  paragraph  of  this
  1720.           section, which  will  allow  you  to  change  the  colour  of  an
  1721.           individual window.
  1722.  
  1723.           When you  select this  option you  will be presented with a menu.
  1724.           The choices are:
  1725.  
  1726.           Main Screen  Colour: This  is the  background on  the main screen
  1727.           where the options window and convenience calendar are located.
  1728.  
  1729.           General Info Line: This is the line at the top of the main screen
  1730.           which has the date, time, Julian date and Calendar Mate version.
  1731.  
  1732.           Options Window:  This window  is on  the main screen and displays
  1733.           the functions available to you.
  1734.  
  1735.           General Info Windows: These windows are displayed periodically in
  1736.           order to  let you  know that  some work  is  in  progress  -  the
  1737.           database is being sorted, a calendar being generated etc.
  1738.  
  1739.           Warning Windows:  These windows  are similar  to the General Info
  1740.           windows except  that  they  warn  you  of  a  possible  error.  A
  1741.           yellow/amber background may be appropriate here.
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  
  1749.      Calendar Mate 4.0 User Reference Guide       Page 30
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.           Error Windows:  These windows  indicate a  problem that  must  be
  1757.           resolved before  the program  can continue, such as a printer not
  1758.           being ready when you asked the program to print a calendar.
  1759.  
  1760.           Another technique  to change  window colours is to simultaneously
  1761.           press the  CNTL and E keys. A little prompting window will appear
  1762.           telling you  what to  do next. Press the left and right arrows to
  1763.           change the  background colour  and the  up and down arrow keys to
  1764.           change the  foreground colour.  When you  are satisfied, press F5
  1765.           and the window colour you selected will be saved for future use.
  1766.  
  1767.           5.4 Select Different Events Files
  1768.  
  1769.           Calendar Mate  will allow  you to  specify the name of the events
  1770.           file you want it to process. As was mentioned at the beginning of
  1771.           the documentation,  you can  specify the  events file name on the
  1772.           command line when you start Calendar.
  1773.  
  1774.           If you  want to change which file Calendar Mate processes, select
  1775.           this option.  You will  be presented  with a list of Events files
  1776.           that Calendar  Mate can locate. These are the files with a second
  1777.           name of  CME (i.e.  CALEVENT.CME). Move the input area beside the
  1778.           events file  you wish  to process,  enter any non-blank character
  1779.           and press  Enter. The  file you  are working on will be saved and
  1780.           the new file opened for processing.
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794.  
  1795.  
  1796.  
  1797.  
  1798.  
  1799.  
  1800.  
  1801.  
  1802.  
  1803.  
  1804.  
  1805.  
  1806.  
  1807.  
  1808.      Option 5: System Parameters                  Page 31                                                       
  1809.  
  1810.  
  1811.  
  1812.  
  1813.  
  1814.  
  1815.           Option 6. DOS Shell
  1816.  
  1817.           This command  will temporarily suspend execution of Calendar Mate
  1818.           and put  you into  DOS. To get back to the program, type EXIT and
  1819.           press <ENTER>.
  1820.  
  1821.           The way  this works  is simple.  Calendar Mate  calls  a  program
  1822.           called COMMAND.COM  which is a DOS program. For this to work, the
  1823.           program has  to be  able to find COMMAND.COM so either have it on
  1824.           the floppy  disk from which you are running Calendar Mate or have
  1825.           it available in the DOS PATH search chain.
  1826.  
  1827.  
  1828.  
  1829.  
  1830.  
  1831.  
  1832.  
  1833.  
  1834.  
  1835.  
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.  
  1856.  
  1857.  
  1858.  
  1859.  
  1860.  
  1861.  
  1862.  
  1863.  
  1864.  
  1865.  
  1866.  
  1867.      Calendar Mate 4.0 User Reference Guide       Page 32
  1868.  
  1869.  
  1870.  
  1871.  
  1872.  
  1873.  
  1874.           Option 7. Print a Calendar
  1875.  
  1876.           This option   allows  you to generate a monthly calendar that you
  1877.           may either print or load to disk and then browse using option 8.
  1878.  
  1879.           When you select option 7, you will be prompted to enter the month
  1880.           and year  of the  calendar you want to print; whether you want to
  1881.           print it,  browse it  on the  screen or  file it  to disk. If you
  1882.           decide to print it on your printer, you will be asked whether you
  1883.           want the  small  calendars  or  not.  If  you  reply  'Y',  small
  1884.           calendars will  print after  the main calendar, two months before
  1885.           and two months after.
  1886.  
  1887.           These small  calendars will  only print  if there  is room on the
  1888.           page. If  there are  six weeks  in the month, the small calendars
  1889.           will not be generated.
  1890.  
  1891.           Printing a Range of Months
  1892.  
  1893.           If you  want to generate more than one month, enter a date in the
  1894.           format
  1895.  
  1896.           aa-bb/cc
  1897.  
  1898.           Where aa  represents the starting month, bb represents the ending
  1899.           month and  cc represents the year. For example to print September
  1900.           - December 1990, specify 9-12/90.
  1901.  
  1902.           Please note that the program must find a dash (-) and a slash (/)
  1903.           to realize  that you  want to print a range of months. Also, note
  1904.           that you may only specify a range of months in the same year. For
  1905.           example you cannot print October 1900 - February 1991 at the same
  1906.           time.
  1907.  
  1908.           Printing a Yearly Calendar
  1909.  
  1910.           As well as printing monthly calendars, you may print a whole year
  1911.           on one  page. To  do this,  specify the month as an asterisk. For
  1912.           example, to print the 1991 calendar, specify
  1913.  
  1914.           *91
  1915.  
  1916.           as the month and year.
  1917.  
  1918.  
  1919.  
  1920.  
  1921.  
  1922.  
  1923.  
  1924.  
  1925.  
  1926.      Option 6: Dos Shell                          Page 33
  1927.  
  1928.  
  1929.  
  1930.  
  1931.  
  1932.  
  1933.           Interrupting Calendar Generation
  1934.  
  1935.           If you  want to  interrupt the  program while  it's generating  a
  1936.           calendar, simply  hit any  key. A window will be displayed asking
  1937.           you if  you really  want to interrupt the process. If you do, hit
  1938.           the ESC  key. If  the program  is sending  a file to disk it will
  1939.           stop and  erase the partially created file. If sending a calendar
  1940.           to the printer it will stop executing immediately and the printer
  1941.           will keep  printing until  its buffer  empties. This could take a
  1942.           while depending on the size of the print buffer.
  1943.  
  1944.           The program  expects a printer to be in the 1st parallel port. If
  1945.           you do  not have  a printer there or if it is not ready to print,
  1946.           an error window will be displayed asking you to ready the printer
  1947.           and to press any key to proceed or to press the ESC key to cancel
  1948.           the task.
  1949.  
  1950.  
  1951.  
  1952.           Monthly Calendar Overflow
  1953.  
  1954.           Sometimes there  are more events jammed into a day than can print
  1955.           in each box of the monthly calendar. If you have compressed print
  1956.           set on,  you can  print up  to  three  events  per  day;  without
  1957.           compressed print: two events.
  1958.  
  1959.           When this  happens, you  will be  presented with a list of events
  1960.           that are  eligible to  go in the box and you will be permitted to
  1961.           choose which  events are  the important ones. Simply put any non-
  1962.           blank character  beside your choice and it will be hilighted. You
  1963.           will not be permitted to choose more events than will fit.
  1964.  
  1965.           If you  highlight an  event and then change your mind, just enter
  1966.           any non-blank  character (like  you did to hilight the event) and
  1967.           it will become "unchosen".
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.      Calendar Mate 4.0 User Reference Guide       Page 34
  1986.  
  1987.  
  1988.  
  1989.  
  1990.  
  1991.  
  1992.           Option 8. Browse Calendar
  1993.  
  1994.           This option  will allow  you to  look at a calendar that you have
  1995.           stored on disk. This will allow you to preview the calendar prior
  1996.           to printing it.
  1997.  
  1998.           The browse  routine  is  not  complicated.  To  move  around  the
  1999.           calendar, use  the arrow  keys. The up and down keys will advance
  2000.           the calendar one week. The right and left arrow keys will advance
  2001.           the calendar  one weekday at a time (if the calendar greater than
  2002.           80 columns wide).
  2003.  
  2004.           If you  are looking  at the  last week of the month and press the
  2005.           down arrow  key, the  display will  move back  to the  first week
  2006.           (wrap around). Similarly, if you are looking at the first week of
  2007.           the month  and press  the up  arrow key,  the display  will  wrap
  2008.           around to the last week of the month.
  2009.  
  2010.           You may  notice some  odd characters  flanking the  name  of  the
  2011.           month. These  are printer  control characters. When you send your
  2012.           file to the printer, they will disappear.
  2013.  
  2014.           If you generated several months and sent the file to disk you can
  2015.           browse one  month at  a time.  To view  the next month, press the
  2016.           plus (+)  key. To  view the  previous month,  press the minus (-)
  2017.           key. The  display will  wrap around  if you pressed the minus key
  2018.           while viewing  the first  month or  if you  pressed the  plus key
  2019.           while viewing the last month you generated.
  2020.  
  2021.  
  2022.  
  2023.  
  2024.  
  2025.  
  2026.  
  2027.  
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.  
  2044.      Option 7: Print a Calendar                   Page 35                                                       
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.           Option 9. Quit
  2052.  
  2053.           This option  closes down  the  program  normally.  It  is  highly
  2054.           recommended that  you end  the program  normally so that the data
  2055.           file can  be saved.  There is an auto-save feature in the program
  2056.           that will save your data periodically but if you have not reached
  2057.           the autosave  threshold, your data may be lost during an abnormal
  2058.           termination of the program.
  2059.  
  2060.  
  2061.  
  2062.  
  2063.  
  2064.  
  2065.  
  2066.  
  2067.  
  2068.  
  2069.  
  2070.  
  2071.  
  2072.  
  2073.  
  2074.  
  2075.  
  2076.  
  2077.  
  2078.  
  2079.  
  2080.  
  2081.  
  2082.  
  2083.  
  2084.  
  2085.  
  2086.  
  2087.  
  2088.  
  2089.  
  2090.  
  2091.  
  2092.  
  2093.  
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.  
  2103.      Calendar Mate 4.0 User Reference Guide       Page 36
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.  
  2110.           Appendix A. Date/Time Formats
  2111.  
  2112.           The author  has attempted to make it as convenient as possible to
  2113.           enter dates  and times  in a  format that  is convenient for you.
  2114.           Here is a list of supported formats:
  2115.  
  2116.           Date Formats
  2117.           *                        Today's date.
  2118.           dd/mm/yy  Eg. 15/10/89        Oct 15, 1989 see note 1
  2119.           mm/dd/yy  Eg. 10/15/89        Oct 15, 1989 see note 2
  2120.           yy/mm/dd  Eg. 89/10/15        Oct 15, 1989 see note 3
  2121.           ddmmmyy   Eg. 15Oct89         Oct 15, 1989
  2122.           ddmmyy    Eg. 151089          Oct 15, 1989 see note 1
  2123.           mmddyy    Eg. 101589          Oct 15, 1989 see note 2
  2124.           yymmdd    Eg. 891015          Oct 15, 1989 see note 3
  2125.  
  2126.           Time Formats
  2127.           730                 7:30 a.m.
  2128.           7:30                7:30 a.m.
  2129.           730a                7:30 a.m.
  2130.           1930                7:30 p.m.
  2131.           19:30               7:30 p.m.
  2132.           730p                7:30 p.m.
  2133.  
  2134.           Note 1: You have to specify dmy in the system parameters (opt
  2135.           5.2)
  2136.           Note 2: You have to specify mdy in the system parameters (opt
  2137.           5.2)
  2138.           Note 3: You have to specify ymd in the system parameters (opt
  2139.           5.2)
  2140.  
  2141.  
  2142.  
  2143.  
  2144.  
  2145.  
  2146.  
  2147.  
  2148.  
  2149.  
  2150.  
  2151.  
  2152.  
  2153.  
  2154.  
  2155.  
  2156.  
  2157.  
  2158.  
  2159.  
  2160.  
  2161.  
  2162.      Option 9: Quit                          Page 37                                                  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.           Appendix B. Data Record Formats
  2170.  
  2171.           The format of the Calendar Mate data records are as follows.
  2172.  
  2173.           Column(s)           Description
  2174.  
  2175.           1                   Indicator Byte
  2176.                               x'01'     for non-repeating event
  2177.                               x'03' for repeating event
  2178.                               x'06' for deleted event
  2179.           2-9                 date          8 bytes
  2180.           10-13               time          4 bytes
  2181.           14-33               descr        20 bytes
  2182.           34                  repeat type   1 byte
  2183.                               (daily, weekly, monthly etc)
  2184.           35                  repeat type b 1 byte     
  2185.                               (like previous byte)
  2186.           36-38               nn days       3 bytes
  2187.                               (like every 3 weeks)
  2188.           39-41               nth day       3 bytes
  2189.                               (like 3rd Sunday of the month)
  2190.           42-49               end repeat    8 bytes
  2191.           50-51               early warning 2 bytes
  2192.                               (Advance notice in days)
  2193.           52                  cal indicator 1 byte
  2194.                               (m, d or b)
  2195.  
  2196.  
  2197.  
  2198.  
  2199.  
  2200.  
  2201.  
  2202.  
  2203.  
  2204.  
  2205.  
  2206.  
  2207.  
  2208.  
  2209.  
  2210.  
  2211.  
  2212.  
  2213.  
  2214.  
  2215.  
  2216.  
  2217.  
  2218.  
  2219.  
  2220.  
  2221.      Calendar Mate 4.0 User Reference Guide       Page 38
  2222.  
  2223.  
  2224.  
  2225.  
  2226.  
  2227.  
  2228.           Appendix C. ASCII Character Set
  2229.  
  2230.  
  2231.                This is  a list  of ASCII  characters from  32 to 126. It is
  2232.           being provided to possibly help you if you have to define printer
  2233.           control characters.  The characters less than 32 and greater than
  2234.           127 are of no use to this discussion.
  2235.  
  2236.           032 <sp>  033  !    034  "    035  #    036  $
  2237.           037  %    038  &    039  '    040  (    041  )
  2238.           042  *    043  +    044  ,    045  -    046  .
  2239.           047  /    048  0    049  1    050  2    051  3
  2240.           052  4    053  5    054  6    055  7    056  8
  2241.           057  9    058  :    059  ;    060  <    061  =
  2242.           062  >    063  ?    064  @    065  A    066  B
  2243.           067  C    068  D    069  E    070  F    071  G
  2244.           072  H    073  I    074  J    075  K    076  L
  2245.           077  M    078  N    079  O    080  P    081  Q
  2246.           082  R    083  S    084  T    085  U    086  V
  2247.           087  W    088  X    089  Y    090  Z    091  [
  2248.           092  \    093  ]    094  ^    095  _    096  `
  2249.           097  a    098  b    099  c    100  d    101  e
  2250.           102  f    103  g    104  h    105  i    106  j
  2251.           107  k    108  l    109  m    110  n    111  o
  2252.           112  p    113  q    114  r    115  s    116  t
  2253.           117  u    118  v    119  w    120  x    121  y
  2254.           122  z    123  {    124  |    125  }    126  ~
  2255.           127 <del>
  2256.  
  2257.  
  2258.  
  2259.  
  2260.  
  2261.  
  2262.  
  2263.  
  2264.  
  2265.  
  2266.  
  2267.  
  2268.  
  2269.  
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.  
  2280.      Appendix B: Data Record Formats              Page 39                                                       
  2281.  
  2282.  
  2283.  
  2284.  
  2285.  
  2286.  
  2287.           Appendix D. Repeating Adjectives
  2288.  
  2289.                This is  a complete list of keywords accepted by the program
  2290.           for describing  repeating events.  You rarely  have to  enter the
  2291.           complete word  -- the  program understands certain abbreviations.
  2292.           The minimum number of characters required to identify the word is
  2293.           supplied as well.
  2294.  
  2295.                Keyword        Minimum        Example               Keyword        Minimum        Example               _______        _______        _______
  2296.  
  2297.                Daily               2         da
  2298.                Weekly              3         wee
  2299.                Monthly             4         mont
  2300.                Yearly              4         year
  2301.                Annually            3         ann
  2302.                Fortnightly         4         fort
  2303.                Day                 2         da
  2304.                Workday             4         work
  2305.                Last                4         last
  2306.                First               5         1st
  2307.                Second              6         2nd
  2308.                Third               5         3rd
  2309.                Fourth              6         4th
  2310.                Monday              4         mond
  2311.                Tuesday             3         tue
  2312.                Wednesday           3         wed
  2313.                Thursday            3         thu
  2314.                Friday              3         fri
  2315.                Saturday            3         sat
  2316.                Sunday              3         sun
  2317.                January             3         jan
  2318.                February            3         feb
  2319.                March               3         mar
  2320.                April               3         apr
  2321.                May                 3         may
  2322.                June                3         jun
  2323.                July                3         jul
  2324.                August              3         aug
  2325.                September           3         sep
  2326.                October             3         oct
  2327.                November            3         nov
  2328.                December            3         dec
  2329.                Easter              3         eas
  2330.  
  2331.  
  2332.  
  2333.  
  2334.  
  2335.  
  2336.  
  2337.  
  2338.  
  2339.      Calendar Mate 4.0 User Reference Guide       Page 40
  2340.  
  2341.  
  2342.  
  2343.  
  2344.  
  2345.  
  2346.           Prefixes:
  2347.  
  2348.                Keyword   Example        Meaning
  2349.                bi        biweekly       every 2 weeks
  2350.                tri       triweekly      every 3 weeks
  2351.  
  2352.           Cosmetic Words:
  2353.  
  2354.                the, of, in, every
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.  
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.  
  2374.  
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380.  
  2381.  
  2382.  
  2383.  
  2384.  
  2385.  
  2386.  
  2387.  
  2388.  
  2389.  
  2390.  
  2391.  
  2392.  
  2393.  
  2394.  
  2395.  
  2396.  
  2397.  
  2398.      Appendix D: Repeating Adjectives             Page 41
  2399.  
  2400.  
  2401.  
  2402.  
  2403.  
  2404.  
  2405.           Appendix E. Some commonly asked questions
  2406.  
  2407.  
  2408.  
  2409.           Q:   Why isn't the calendar printing the proper month? I'm       
  2410.                getting December 1900!
  2411.  
  2412.           A:   You probably specified a date in a format that Calendar Mate
  2413.                misunderstood. The  most common  error is  putting  a  space
  2414.                between the  month and  year (eg.  Dec 90 instead of Dec90).
  2415.                Have a look in appendix A for a list of acceptable formats.
  2416.  
  2417.  
  2418.  
  2419.           Q:   I am  trying to  print in compressed mode and the events are
  2420.                printing on  different lines  than the  box characters.  The
  2421.                calendar takes  up one  and a  half pages  instead  of  one.
  2422.                What's the matter?
  2423.  
  2424.           A:   In compressed mode, Calendar Mate prints the outline for the
  2425.                box, does a carriage return and then prints the events. This
  2426.                works for  most printers.  Some  printers,  however,  do  an
  2427.                automatic line  feed in  tandem with a carriage return. This
  2428.                can usually  be disabled  by setting  a dip  switch. In  the
  2429.                author's printer manual, the terminology is "Auto Feed XT".
  2430.  
  2431.           Q:   When I  print a  calendar I  get italic Cs and Ds instead of
  2432.                lines around  the borders.  Does Calendar  Mate  support  my
  2433.                printer?
  2434.  
  2435.           A:   Calendars printed with Calendar Mate should look like you   
  2436.                would expect a calendar to look -- with nice clean lines. If
  2437.                your printer  isn't printing properly, try using a different
  2438.                print driver, selectable in option 5.1.1. Alternatively, run
  2439.                the SETUP program on the Calendar Mate distribution disk. If
  2440.                all else  fails, you  can try  using 'Plain' characters. See
  2441.                the discussion in section 5.1.2 above.
  2442.  
  2443.           Q:   What settings  should I use to print a calendar in landscape
  2444.                mode on my LaserJet printer?
  2445.  
  2446.           A:   Load the  print driver  called HPLJIIPL (using option 5.1.1)
  2447.                and set the printer width to 99.
  2448.  
  2449.  
  2450.  
  2451.  
  2452.  
  2453.  
  2454.  
  2455.  
  2456.  
  2457.      Calendar Mate 4.0 User Reference Guide       Page 42
  2458.  
  2459.  
  2460.  
  2461.  
  2462.  
  2463.  
  2464.  
  2465.  
  2466.           Q:   When I  start up Calendar Mate, there is no help information
  2467.                and it cannot find my events file!
  2468.  
  2469.           A:   All of  Calendar Mate's  files have  to reside  in the  same
  2470.                subdirectory as  the program  and you  have to  be  in  that
  2471.                subdirectory when  you start  Calendar Mate. For example, if
  2472.                Calendar Mate  resides in C:\CALENDAR and you're in C:\QEDIT
  2473.                when you  start up  calendar, it  won't be  able to find the
  2474.                help file, parm file and events file.
  2475.  
  2476.                The exception  to this  rule is  if you have the Environment
  2477.                Variable set.  This procedure  is described  in the  section
  2478.                entitled 'The DOS Environment'
  2479.  
  2480.  
  2481.  
  2482.  
  2483.  
  2484.  
  2485.  
  2486.  
  2487.  
  2488.  
  2489.  
  2490.  
  2491.  
  2492.  
  2493.  
  2494.  
  2495.  
  2496.  
  2497.  
  2498.  
  2499.  
  2500.  
  2501.  
  2502.  
  2503.  
  2504.  
  2505.  
  2506.  
  2507.  
  2508.  
  2509.  
  2510.  
  2511.  
  2512.  
  2513.  
  2514.  
  2515.  
  2516.      Appendix E: Common Questions                 Page 43
  2517.  
  2518.  
  2519.  
  2520.  
  2521.  
  2522.  
  2523.           Appendix F. Order Form
  2524.  
  2525.                                    Order Form For
  2526.                               Calendar Mate Version 4.0
  2527.  
  2528.                Name:          __________________________________________
  2529.  
  2530.                Address:       __________________________________________
  2531.  
  2532.                City:          __________________________________________
  2533.  
  2534.                Province/State:__________________________________________
  2535.  
  2536.                Postal Code/Zip:_________________________________________
  2537.  
  2538.                Country:       __________________________________________
  2539.  
  2540.  
  2541.  
  2542.                Registration Fee:             $22.00
  2543.                Shipping & Handling           $ 3.00
  2544.                Saskatchewan Residents Add:   $ 1.75    (7% Sales Tax)
  2545.                Canadian Residents Add:       $ 1.75    (7% GST)
  2546.                                              ======
  2547.  
  2548.                Total:                        ______
  2549.  
  2550.                Diskette Size   ____ 5.25"          ____ 3.5"
  2551.  
  2552.                Please return this form to:
  2553.  
  2554.                               Hawk Software
  2555.                               PO Box 3961
  2556.                               Regina, Saskatchewan
  2557.                               S4P 3R9
  2558.                               Canada
  2559.  
  2560.                How did you find out about Calendar Mate?
  2561.  
  2562.                [  ] Friend    [  ] Compuserve     
  2563.  
  2564.                [  ] Bulletin Board ______________________ (which one?)
  2565.  
  2566.                [  ] Shareware Library _______________ (which one?)
  2567.  
  2568.                Does your PC have a Hard Drive?  [  ]Yes  [  ]No
  2569.  
  2570.  
  2571.  
  2572.  
  2573.  
  2574.  
  2575.      Calendar Mate 4.0 User Reference Guide       Page 44
  2576.  
  2577.  
  2578.  
  2579.  
  2580.  
  2581.  
  2582.                What kind of printer do you use? ___________________________
  2583.  
  2584.                Which Calendar Mate print driver works?_____________________
  2585.  
  2586.                Is mouse support useful? [  ]Yes   [  ]No
  2587.                                         [  ] I don't have a mouse
  2588.  
  2589.                Please feel free to add your comments and suggestions on how
  2590.                Calendar Mate can be improved to better meet your needs...
  2591.  
  2592.                __________________________________________________________
  2593.  
  2594.                __________________________________________________________
  2595.  
  2596.                __________________________________________________________
  2597.  
  2598.                __________________________________________________________
  2599.  
  2600.                __________________________________________________________
  2601.  
  2602.                __________________________________________________________
  2603.  
  2604.                __________________________________________________________
  2605.  
  2606.                __________________________________________________________
  2607.  
  2608.                __________________________________________________________
  2609.  
  2610.  
  2611.  
  2612.  
  2613.  
  2614.  
  2615.  
  2616.  
  2617.  
  2618.  
  2619.  
  2620.  
  2621.  
  2622.  
  2623.  
  2624.  
  2625.  
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.  
  2633.  
  2634.      Order Form                                   Page 45
  2635.  
  2636.  
  2637.  
  2638.  
  2639.  
  2640.  
  2641.           Appointment Extend  13
  2642.           Calendar
  2643.             browsing printed  35
  2644.             convenience  8
  2645.             daily  21, 28
  2646.             improper date printed  42
  2647.             monthly,printing  25, 33
  2648.             printer requirements  5
  2649.             printing tiny  33
  2650.           Colour  30, 31
  2651.             changing  24
  2652.             changing - ^E key  31
  2653.             changing - option 5.3  30
  2654.           Compressed print
  2655.             restrictions  29
  2656.           Convenience Calendar  8
  2657.           Daily Calendar
  2658.             Printing  11
  2659.           Data
  2660.             missing files  43
  2661.           Date  8
  2662.             changing  11
  2663.             changing event's  17
  2664.             event's end  22
  2665.             formats  20, 27
  2666.             Julian  8, 28, 30
  2667.             setting DOS  8
  2668.             specifying  42
  2669.           Date/Time Formats  37
  2670.           DOS Environment  7
  2671.           Environment Variable  7
  2672.           Event  11, 15
  2673.             changing  17
  2674.             database  16
  2675.             deleting  15, 27
  2676.             description  20
  2677.             early warning  21
  2678.             end date  22
  2679.             entering  12
  2680.             file  38
  2681.             printing  21
  2682.             repeating  21
  2683.             special repeater  21
  2684.           Events
  2685.             special repeaters  21
  2686.           Events File
  2687.             changing - option 5.4  31
  2688.  
  2689.  
  2690.  
  2691.  
  2692.  
  2693.      Calendar Mate 4.0 User Reference Guide       Page 46
  2694.  
  2695.  
  2696.  
  2697.  
  2698.  
  2699.  
  2700.           Files
  2701.             missing  43
  2702.           Graphics characters  29
  2703.           Help Info  5
  2704.           Monthly Calendar Overflow  34
  2705.           Options Menu  10
  2706.           Order Form  44
  2707.           Primary Menu  8
  2708.           Printer
  2709.             problems  42
  2710.           Printer Parameters  24
  2711.           Program Parameters  27
  2712.             Auto save number  29
  2713.             Auto Sort Data  27
  2714.             Compressed Print  29
  2715.             Current Century  28
  2716.             Date Format  27
  2717.             Disk Width  29
  2718.             End of Workday  28
  2719.             Immediate purge  27
  2720.             Julian Date  28
  2721.             Lunar Cycle  29
  2722.             Override Ewarn  30
  2723.             Print Language  28
  2724.             Slots per Hour  28
  2725.             Sort by time  28
  2726.             Start of Workday  28
  2727.           Repeating events
  2728.             adding  20, 21
  2729.             describing  22
  2730.             end date  22
  2731.             viewing  16
  2732.           Shareware  3, 44
  2733.           System Requirements  5
  2734.           The Setup Program  7
  2735.           Time
  2736.             appointment extend  13
  2737.             changing event's  17
  2738.             current  8, 30
  2739.             entering event's  20
  2740.             formats  37
  2741.             setting DOS  8
  2742.             slots  11, 12, 28
  2743.             slots per hour  28
  2744.             sorting records  16
  2745.           Yearly Calendar
  2746.             Printing  33
  2747.  
  2748.  
  2749.  
  2750.  
  2751.  
  2752.      Order Form                                   Page 47